
------------------------------------------
 Grasshopper-Tekla Live Link installation
==========================================

1. Close down Rhino and Grasshopper if you're updating from an older link version

2. Extract GrasshopperTeklaLink.gha and GrasshopperTeklaLink.Setup.exe into any location on the disk.

3. Run GrasshopperTeklaLink.Setup.exe and allow admin rights if asked for.
   This will unblock the .gha and replace any old link version.

4. If using Rhino 8, launch Rhino and type the command 'SetDotNetRuntime' and select 'NETFramework', then restart Rhino.

5. Restart Rhino and Grasshopper if you haven't already (have a model open in Tekla first).


------------------------------------------
 Manual installation for 2023 and older
==========================================

In Tekla version 2023 or older, you can just copy the .gha directly into the Grasshopper Libraries folder.

    a. Open the Grasshopper Libraries folder 
         - The folder can be opened from within Grasshopper in the File menu > Special Folders > Components Folder.
         - The path will look e.g. like this: C:\Users\[username]\AppData\Roaming\Grasshopper\Libraries

    b. Extract the GrasshopperTeklaLink.gha into the libraries folder, replacing any existing file.

    c. Unblock the GrasshopperTeklaLink.gha if needed:
         - Right-click the copied GrasshopperTeklaLink.gha in the GrasshopperTeklaLink folder and select Properties.
         - Under the General tab, click on the Unblock button, and click OK.
         - If you don’t see an Unblock button, the file is not blocked.


------------------------------------------
 Manual installation for 2024
==========================================

In Tekla version 2024 or newer, you can copy the .gha to the Tekla Structures bin folder and then create a text file
with the extension .ghlink in the Grasshopper Libraries folder containing the path to the Tekla Structures bin folder.

    a. Open the Tekla Structures bin folder e.g. C:\Program Files\Tekla Structures\2024.0\bin\

    b. Extract the GrasshopperTeklaLink.gha into the bin folder, replacing any existing file.

    c. Unblock the GrasshopperTeklaLink.gha if needed:
         - Right-click the copied GrasshopperTeklaLink.gha in the GrasshopperTeklaLink folder and select Properties.
         - Under the General tab, click on the Unblock button, and click OK.
         - If you don’t see an Unblock button, the file is not blocked.

    d. Open the Grasshopper Libraries folder 
         - The folder can be opened from within Grasshopper in the File menu > Special Folders > Components Folder.
         - The path will look e.g. like this: C:\Users\[username]\AppData\Roaming\Grasshopper\Libraries
    
    e. Create a simple text file called GrasshopperTeklaLink.ghlink and place it in the libraries folder.
         - The content of the file should just be the path to the Tekla Structures bin folder.

If you're not allowed to put anything into the Tekla Structures bin folder, the other option is to put the .gha into the
Grasshopper Libraries folder as normal and then copy all the required Tekla Structures API libraries from the bin
folder into the Libraries folder. These include
	Common.dll
	DotNetKit.dll
	System.Runtime.CompilerServices.Unsafe.dll
	Tekla.Application.Library.dll
	Tekla.Structures.Catalogs.dll
	Tekla.Structures.Datatype.dll
	Tekla.Structures.Dialog.dll
	Tekla.Structures.dll
	Tekla.Structures.Drawing.dll
	Tekla.Structures.Model.dll
	Tekla.Structures.Plugins.dll
	Tekla.Technology.Serialization.dll
	Tekla.Technology.Tkit.ContentAttributes.dll
	Trimble.Package.Manager.dll
	Trimble.Remoting.dll
	Trimble.Technology.MsgLib.dll
	Trimble.Technology.Rkit.dll

Note that in this case, if you install another Tekla Structures service pack or build, you will need to copy and replace
all the above mentioned dll:s from the new Tekla install.


